home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / archiver / arc.zoo / Arc521.doc < prev    next >
Text File  |  1988-11-16  |  54KB  |  2,101 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                           ARC
  14.  
  15.                  File Archive Utility
  16.                      Version 5.20
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                  (C)COPYRIGHT 1985,86
  43.                           by
  44.           System Enhancement Associates, Inc.
  45.                   ALL RIGHTS RESERVED
  46.  
  47.  
  48.  
  49.  
  50.  
  51. This document describes version 5.20 of the ARC file
  52. utility, which was created by System Enhancement
  53. Associates, Inc. in October of 1986.
  54.  
  55.  
  56.        TABLE OF CONTENTS
  57.  
  58.  
  59.  
  60. Section                                           Page
  61.  
  62.  
  63. Introduction  ....................................   1
  64. Using ARC  .......................................   3
  65. ARC commands  ....................................   5
  66.     Adding files  ................................   5
  67.     Extracting files  ............................   7
  68.     Deleting files  ..............................   8
  69.     Listing archive entries  .....................   8
  70.     Running files  ...............................  10
  71.     Printing files  ..............................  11
  72.     Testing an archive  ..........................  11
  73.     Converting an archive  .......................  12
  74. ARC options  .....................................  13
  75.     Suppressing compression  .....................  13
  76.     Backup retention  ............................  14
  77.     Message suppression  .........................  15
  78.     Encryption/Decryption  .......................  17
  79. RAMdisk support  .................................  18
  80. MARC  ............................................  19
  81. ARCE  ............................................  20
  82. Version numbers  .................................  21
  83. Common questions and answers  ....................  22
  84. Maintenance contracts  ...........................  24
  85. Revision history  ................................  25
  86.     Changes in version 3  ........................  25
  87.     Changes in version 4  ........................  25
  88.     Changes in version 4.1  ......................  26
  89.     Changes in version 4.3  ......................  26
  90.     Changes in version 4.4  ......................  27
  91.     Changes in version 4.5  ......................  27
  92.     Changes in version 5.0  ......................  28
  93.     Changes in version 5.1  ......................  29
  94.     Changes in version 5.2  ......................  30
  95. Program history and credits  .....................  31
  96. Bulletin boards  .................................  33
  97. Site licenses  ...................................  34
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.          INTRODUCTION
  112.  
  113.  
  114.  
  115. ARC is the copyrighted property of System Enhancement
  116. Associates, Inc.  You are granted a limited license to
  117. use ARC, and to copy it and distribute it, provided
  118. that the following conditions are met:
  119.  
  120. 1) No fee may be charged for such copying and
  121.    distribution.
  122.  
  123. 2) ARC may ONLY be distributed in its original,
  124.    unmodified state.
  125.  
  126. 3) ARC may *not* be distributed, in whole or in part, as
  127.    part of any commercial product or service without
  128.    the express written permission of System
  129.    Enhancement Associates.
  130.  
  131.  
  132. Contributions for the use of this program will be
  133. appreciated, and should be sent to:
  134.  
  135.           System Enhancement Associates, Inc.
  136.              21 New Street, Wayne NJ 07470
  137.  
  138. You may not use this product in a commercial
  139. environment or a governmental organization without
  140. paying a license fee of $35.  Site licenses and
  141. commercial distribution licenses are available.  A
  142. program disk and printed documentation are available
  143. for $50.  See the order form enclosed with this manual
  144. for more details.
  145.  
  146.  
  147.  
  148. ARC is user supported software.  This means that you
  149. may copy it freely and give the copies away to anyone
  150. you wish, at no cost.  They are in turn requested to
  151. send in a contribution if they decide to use it.
  152.  
  153. The user supported software concept (often referred to
  154. as "shareware") is an attempt to provide software at low
  155. cost.  The cost of offering a new product by
  156. conventional means is staggering, and hence dissuades
  157. many independent authors and small companies from
  158. developing and promoting their ideas.  User supported
  159. software is an attempt to develop a new marketing
  160. channel, where products can be introduced at low cost.
  161.  
  162.  
  163.  
  164.  
  165. ARC                                              Page 1
  166. If user supported software works, then everyone will
  167. benefit.  The user will benefit by receiving quality
  168. products at low cost, and by being able to "test
  169. drive" software thoroughly before purchasing it.  The
  170. author benefits by being able to enter the commercial
  171. software arena without first needing large sources of
  172. venture capital.
  173.  
  174. But it can only work with your support.  We're not
  175. just talking about ARC here, but about all user
  176. supported software.  If you obtain a user supported
  177. program from a friend or colleague, and are still
  178. using it after a couple of weeks, then it is obviously
  179. worth something to you, and a contribution should be
  180. sent.
  181.  
  182.  
  183.  
  184. And now, back to ARC:
  185.  
  186. ARC is used to create and maintain file archives.  An
  187. archive is a group of files collected together into
  188. one file in such a way that the individual files may
  189. be recovered intact.
  190.  
  191. ARC is different from other archive and library
  192. utilities in that it automatically compresses the
  193. files being archived, so that the resulting archive
  194. takes up a minimum amount of space.
  195.  
  196. When ARC is used to add a file to an archive it
  197. analyzes the file to determine which of three storage
  198. methods will result in the greatest savings.  These
  199. three methods are:
  200.  
  201. 1) No compression; the file is stored as is.
  202.  
  203. 2) Repeated-character compression; repeated sequences
  204.    of the same byte value are collapsed into a three-
  205.    byte code sequence.
  206.  
  207. 3) Dynamic Lempel-Zev compression;  the file is stored
  208.    as a series of variable size bit codes which
  209.    represent character strings, and which are created
  210.    "on the fly".
  211.  
  212. Note that since one of the three methods involves no
  213. compression at all, the resulting archive entry will
  214. never be larger than the original file.
  215.  
  216.  
  217.  
  218.  
  219.  
  220. ARC                                              Page 2
  221.            USING ARC
  222.  
  223.  
  224.  
  225. ARC is invoked with a command of the following format:
  226.  
  227.     ARC <x> <arcname> [<template> . . .]
  228.  
  229. Where:
  230.  
  231.     <x> is an ARC command letter (see below), in
  232.     either upper or lower case.
  233.  
  234.     <arcname> is the name of the archive to act on,
  235.     with or without an extension.  If no extension is
  236.     supplied, then ".ARC" is assumed.  The archive
  237.     name may include path and drive specifiers.
  238.  
  239.     <template> is one or more file name templates.
  240.     The "wildcard" characters "*" and "?" may be used.
  241.     A file name template may include a path or drive
  242.     specifier, though it isn't always meaningful.
  243.  
  244.  
  245. If ARC is invoked with no arguments (by typing "ARC",
  246. and pressing "enter"), then a brief command summary is
  247. displayed.
  248.  
  249.  
  250.  
  251. Following is a brief summary of the available ARC
  252. commands:
  253.  
  254.     a   = add files to archive
  255.     m   = move files to archive
  256.     u   = update files in archive
  257.     f   = freshen files in archive
  258.     d   = delete files from archive
  259.     x,e = extract files from archive
  260.     r   = run files from archive
  261.     p   = copy files from archive to standard output
  262.     l   = list files in archive
  263.     v   = verbose listing of files in archive
  264.     t   = test archive integrity
  265.     c   = convert entry to new packing method
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275. ARC                                              Page 3
  276. Following is a brief summary of the available ARC
  277. options, which may alter how a command works:
  278.  
  279.     b   = retain backup copy of archive
  280.     s   = suppress compression (store only)
  281.     w   = suppress warning messages
  282.     n   = suppress notes and comments
  283.     o   = overwrite existing files when extracting
  284.     g   = encode or decode archive entry
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330. ARC                                              Page 4
  331.          ARC COMMANDS
  332.  
  333.  
  334.  
  335. This section describes each of the commands.  ARC will
  336. accept any one command at a time.  If no commands are
  337. given, then a brief command list is displayed.
  338.  
  339.  
  340.  
  341. ADDING FILES
  342.  
  343. Files are added to an archive using the "A" (Add), "M"
  344. (Move), "U" (Update), or "F" (Freshen) commands.  Add
  345. always adds the file.  Move differs from Add in that
  346. the source file is deleted once it has been added to
  347. the archive.
  348.  
  349. Update differ